<?php
namespace app\api\interfaces;
/**
 * @name 消息模块
 * @sort 4
 */

interface MsgInterface
{
    /**
     * @name  <span style="color:red">一般群发</span>消息
     * @sort 1
     * @post k:appid,v:wx403a8141dca36f45,t:微信公众号appid,n:
     * @post k:user_name,v:xxxxxxx,t:发送者名称,n:
     * @post k:type,v:image,t:群发类型（text：文本、news：素材图文）,n:
     * @post k:content,v:,t:文本内容（type=text：文本，type=其他：media_id：（存在传递，不存在传递0））,n:
     * @post k:articles,v:,t:{""：""}（type=news）
     * @post k:to_type,v:1,t:发送对象（1：全部粉丝、2：游客、3：潜客）,n:
     * @post k:subscribe,v:1,t:关注时间（1：全部时间、2：最近一周、3：最近两周，4：最近一个月，2018-06-06 2018-07-09：自定义时间）,n:
     * @post k:age,v:1,t:年龄标签（1：60后，2：70后，3：80后，4：90后，5：00后，6：未知;默认为6）
     * @post k:sex,v:1,t:性别（1：男、2：女）
     * @post k:education,v:1,t:教育（1：本科以上、2：大专、3：高中、4：初中、5：小学、6：其他；）
     * @post k:territory,v:1,t:地域（1：华东、2：华南、3：华北、4：东北、5：西南、6：西北、7：华中、8：其他）
     * @post k:source,v:1,t:来源（1：公众号搜索、2：公众号迁移、3：名片分享、4：图文页内名称点击、5：扫描二维码、6：图文页右上角菜单、7：支付后关注、8：其他来源）
     * @post k:active_level,v:1,t:活跃度（1：高；2：中；3：低；）
     * @post k:industry,v:1,t:行业（ 1：IT、2：制造、3：金融、4：政府机构、5：能源、6：其他）
     * @post k:financial_consumption,v:1,t:消费偏好（1：银行类，2：保险类，3：证券，4：信托，5：基金，6：第三方机构，7：未知）
     * @post k:content_style,v:1,t:内容形式偏好（1：消息、2：图文、3：视频、4：活动、5：游戏、6：其他）
     * @post k:consumption_ability,v:1,t:消费能力（1：强；2：中；3：低；4：未知）
     * @post k:tags,v:,t:自定义用户标签id（多个逗号隔开）
     * @post-remark-articles [{"title#标题":"你好","thumb_media_id#图文消息的封面图片素材id（必须是永久mediaID）":"dadasdas4635aas","show_cover_pic#是否显示封面，0不显示，1显示":"0","content":"具体内容（可以包含html其中的图片必须先要上传到微信）","content_source_url#原文地址":"https://blog.csdn.net/znit2003/article/details/41699055","author#作者（可以不传值）":"张三", "digest#摘要（可以不传值）":"64字符"},{"":""}]
     * @case {"code":200,"flag":true,"msg":"已更新粉丝数据","data":[],"success":true,"errorData":[],"md5":"bf7823b4c63540c484632b2db1b844f1","alg":"SALT_MD5"}
     * @remark 错误返回json:{"code":401,"flag":false,"msg":"公众号未授权","data":[],"success":false,"errorData":[],"md5":"bf7823b4c63540c484632b2db1b844f1","alg":"SALT_MD5"}
     */
    public function actionSend_msg();

    /**
     * @name  <span style="color:red">潜客群发文章</span>消息
     * @sort 2
     * @post k:appid,v:wx403a8141dca36f45,t:微信公众号appid,n:
     * @post k:type,v:news,t:群发类型（news：素材图文）,n:
     * @post k:user_name,v:xxxxxxx,t:发送者名称,n:
     * @post k:title,v:七夕节,t:文章标题,n:
     * @post k:article_tag,v:xxxxxxxxxx,t:文章标签,n:
     * @post k:article_type,v:xxxxxxxxxx,t:文章类型,n:
     * @post k:thumb_media_id,v:xxxxxxxxxx,t:封面图片：发布到微信封面的图片：图片素材的media_id,n:
     * @post k:author,v:xxxxxxxxxx,t:作者
     * @post k:digest,v:xxxxxxxxxx,t:文章摘要
     * @post k:show_cover_pic,v:0,t:是否显示封面，0：不显示，1：显示(默认为0)
     * @post k:access_connection,v:1,t:访问连接类型（1：h5(外部连接)、2：微信自定义连接）,n:
     * @post k:url,v:xxxxxxxxxxxxxxx,t:访问连接，
     * @post k:content,v:,t:内容,n:
     * @post k:to_type,v:1,t:发送对象（1：全部粉丝、2：游客、3：潜客）,n:
     * @post k:subscribe,v:1,t:关注时间（1：全部时间、2：最近一周、3：最近两周，4：最近一个月，2018-06-06 2018-07-09：自定义时间）,n:
     * @post k:age,v:1,t:年龄标签（1：60后，2：70后，3：80后，4：90后，5：00后，6：未知;默认为6）
     * @post k:sex,v:1,t:性别（1：男、2：女）
     * @post k:education,v:1,t:教育（1：本科以上、2：大专、3：高中、4：初中、5：小学、6：其他；）
     * @post k:territory,v:1,t:地域（1：华东、2：华南、3：华北、4：东北、5：西南、6：西北、7：华中、8：其他）
     * @post k:source,v:1,t:来源（1：公众号搜索、2：公众号迁移、3：名片分享、4：图文页内名称点击、5：扫描二维码、6：图文页右上角菜单、7：支付后关注、8：其他来源）
     * @post k:active_level,v:1,t:活跃度（1：高；2：中；3：低；）
     * @post k:industry,v:1,t:行业（ 1：IT、2：制造、3：金融、4：政府机构、5：能源、6：其他）
     * @post k:financial_consumption,v:1,t:消费偏好（1：银行类，2：保险类，3：证券，4：信托，5：基金，6：第三方机构，7：未知）
     * @post k:content_style,v:1,t:内容形式偏好（1：消息、2：图文、3：视频、4：活动、5：游戏、6：其他）
     * @post k:consumption_ability,v:1,t:消费能力（1：强；2：中；3：低；4：未知）
     * @post k:tags,v:,t:自定义用户标签id（多个逗号隔开）
     * @case {"code":200,"flag":true,"msg":"已更新粉丝数据","data":[],"success":true,"errorData":[],"md5":"bf7823b4c63540c484632b2db1b844f1","alg":"SALT_MD5"}
     * @remark 文章中使用的图片，可以使素材里边的图片，要使用新图片，有两种方式：<p>1.增加图片素材（有张数限制）。</p><p>2：使用<span style='color:red'>《素材模块=>上传图文内的图片获取URL》</span>API上传图片获取地址。</p>
     */
    public function actionSubmersible_send_msg();

    /**
     * @name  删除<span style='color:red'>群发消息</span>记录
     * @sort 3
     * @post k:appid,v:wx403a8141dca36f45,t:第三方平台的appid,n:
     * @post k:id,v:8141dca36f45,t:消息id,n:
     * @case {"code":200,"flag":true,"msg":"删除成功！","data":[],"success":true,"errorData":[],"md5":"bf7823b4c63540c484632b2db1b844f1","alg":"SALT_MD5"}
     */
    public function actionSend_msg_del();

    /**
     * @name  删除<span style='color:red'>潜客发布</span>的文章
     * @sort 4
     * @post k:appid,v:wx403a8141dca36f45,t:第三方平台的appid,n:
     * @post k:id,v:8141dca36f45,t:文章id,n:
     * @case {"code":200,"flag":true,"msg":"删除成功！","data":[],"success":true,"errorData":[],"md5":"bf7823b4c63540c484632b2db1b844f1","alg":"SALT_MD5"}
     */
    public function actionSubmersible_msg_del();

    /**
     * @name  微信模板发送到公众号
     * @sort 5
     * @post k:appid,v:wx403a8141dca36f45,t:第三方平台的appid,n:
     * @post k:id,v:8141dca36f45,t:模板ID,n:
     * @case {"code":200,"flag":true,"msg":"发布成功！","data":[],"success":true,"errorData":[],"md5":"bf7823b4c63540c484632b2db1b844f1","alg":"SALT_MD5"}
     */
    public function actionTemplate_send();




//    /**
//     * @name  群发新建图文消息素材
//     * @sort 3
//     * @post k:appid,v:wx403a8141dca36f45,t:微信公众号appid,n:
//     * @post k:articles,v:{""：""},t:图文数据json,n:
//     * @post-remark-articles [{"title#标题":"你好","thumb_media_id#图文消息的封面图片素材id（必须是永久mediaID）":"dadasdas4635aas","show_cover_pic#是否显示封面，0不显示，1显示":"0","content":"具体内容（可以包含html其中的图片必须先要上传到微信）","content_source_url#原文地址":"https://blog.csdn.net/znit2003/article/details/41699055","author#作者（可以不传值）":"张三", "digest#摘要（可以不传值）":"64字符"},{"":""}]
//     * @case {"media_id#素材微信id":"ajksdhakjsdh235341"}
//     * @remark <p>1、content：图文消息的具体内容，支持HTML标签，必须少于2万字符，小于1M，且此处会去除JS,涉及图片url必须来源 "上传图文消息内的图片获取URL"接口获取。外部图片url将被过滤</p>
//     */
//    public function actionArticle_upload();
//

//
//    /**
//     * @name  发送<span style="color:red">视频</span>消息
//     * @sort 4
//     * @post k:appid,v:wx403a8141dca36f45,t:第三方平台的appid,n:
//     * @case {"code":200,"flag":true,"msg":"已更新粉丝数据","data":[],"success":true,"errorData":[],"md5":"bf7823b4c63540c484632b2db1b844f1","alg":"SALT_MD5"}
//     * @remark 错误返回json:{"code":401,"flag":false,"msg":"公众号未授权","data":[],"success":false,"errorData":[],"md5":"bf7823b4c63540c484632b2db1b844f1","alg":"SALT_MD5"}
//     */
//    public function actionVideo_Send();
//
//    /**
//     * @name  发送<span style="color:red">音乐</span>消息
//     * @sort 5
//     * @post k:appid,v:wx403a8141dca36f45,t:第三方平台的appid,n:
//     * @case {"code":200,"flag":true,"msg":"已更新粉丝数据","data":[],"success":true,"errorData":[],"md5":"bf7823b4c63540c484632b2db1b844f1","alg":"SALT_MD5"}
//     * @remark 错误返回json:{"code":401,"flag":false,"msg":"公众号未授权","data":[],"success":false,"errorData":[],"md5":"bf7823b4c63540c484632b2db1b844f1","alg":"SALT_MD5"}
//     */
//    public function actionMusic_Send();
//    /**
//     * @name  发送<span style="color:red">图文</span>消息
//     * @sort 6
//     * @post k:appid,v:wx403a8141dca36f45,t:第三方平台的appid,n:
//     * @case {"code":200,"flag":true,"msg":"已更新粉丝数据","data":[],"success":true,"errorData":[],"md5":"bf7823b4c63540c484632b2db1b844f1","alg":"SALT_MD5"}
//     * @remark 错误返回json:{"code":401,"flag":false,"msg":"公众号未授权","data":[],"success":false,"errorData":[],"md5":"bf7823b4c63540c484632b2db1b844f1","alg":"SALT_MD5"}
//     */
//    public function actionNews_Send();
}